<html>
  <head>
    <meta name="viewport" content="width=device-width, initial-scale=1" charset="UTF-8">
    <title>replaceSpan</title>
<link href="../../../../images/logo-icon.svg" rel="icon" type="image/svg"><script>var pathToRoot = "../../";</script><script type="text/javascript" src="../../scripts/sourceset_dependencies.js" async="async"></script><link href="../../styles/style.css" rel="Stylesheet"><link href="../../styles/logo-styles.css" rel="Stylesheet"><link href="../../styles/jetbrains-mono.css" rel="Stylesheet"><link href="../../styles/main.css" rel="Stylesheet"><script type="text/javascript" src="../../scripts/clipboard.js" async="async"></script><script type="text/javascript" src="../../scripts/navigation-loader.js" async="async"></script><script type="text/javascript" src="../../scripts/platform-content-handler.js" async="async"></script><script type="text/javascript" src="../../scripts/main.js" async="async"></script>  </head>
  <body>
    <div id="container">
      <div id="leftColumn"><a href="../../index.html">
          <div id="logo"></div>
        </a>
        <div id="paneSearch"></div>
        <div id="sideMenu"></div>
      </div>
      <div id="main">
        <div id="leftToggler"><span class="icon-toggler"></span></div>
<script type="text/javascript" src="../../scripts/main.js"></script>        <div class="main-content" id="content" pageIds="Engine::com.drake.engine.text//replaceSpan/kotlin.CharSequence#kotlin.String#kotlin.Boolean#kotlin.Function1[kotlin.text.MatchResult,kotlin.Any?]/PointingToDeclaration//-1683276876">
          <div class="navigation-wrapper" id="navigation-wrapper">
            <div class="breadcrumbs"><a href="../../index.html">Engine</a>/<a href="index.html">com.drake.engine.text</a>/<a href="replace-span.html">replaceSpan</a></div>
            <div class="pull-right d-flex">
              <div id="searchBar"></div>
            </div>
          </div>
          <div class="cover ">
            <h1 class="cover"><span>replace</span><wbr></wbr><span>Span</span></h1>
          </div>
<div class="divergent-group" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="with-platform-tags"><span class="pull-right"></span></div>

  <div>
    <div class="platform-hinted " data-platform-hinted="data-platform-hinted"><div class="content sourceset-depenent-content" data-active="" data-togglable=":engine:dokkaHtml/release"><div class="symbol monospace">fun <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a>.<a href="replace-span.html">replaceSpan</a>(oldValue: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html">String</a>, ignoreCase: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html">Boolean</a> = false, replacement: (<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/index.html">MatchResult</a>) -&gt; <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html">Any</a>?): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a><span class="top-right-position"><span class="copy-icon"></span><div class="copy-popup-wrapper popup-to-left"><span class="copy-popup-icon"></span><span>Content copied to clipboard</span></div></span></div></div></div>
  </div>
<p class="paragraph">替换匹配的字符串</p><h4 class="">Return</h4><p class="paragraph">如果没有匹配任何项会返回原来的<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a></p><h2 class="">Parameters</h2><div data-togglable="Parameters"><div class="platform-hinted WithExtraAttributes" data-platform-hinted="data-platform-hinted" data-togglable="Parameters"><div class="content sourceset-depenent-content" data-active="" data-togglable=":engine:dokkaHtml/release"><div data-togglable="Parameters"><div class="table" data-togglable="Parameters"><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">oldValue</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">被替换的字符串</p></div></div></div></div></div><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">ignoreCase</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">忽略大小写</p></div></div></div></div></div><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">replacement</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">每次匹配到字符串都会调用此函数</p><ol><li><p class="paragraph">如果返回null则表示不执行任何操作</p></li><li><p class="paragraph">返回单个Span则应用效果, 当然返回Span集合或数组就会应用多个效果,</p></li><li><p class="paragraph">返回<a href="https://developer.android.com/reference/kotlin/android/text/Spanned.html">android.text.Spanned</a>可以替换字符串同时添加Span效果.</p></li><li><p class="paragraph">返回<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">kotlin.CharSequence</a>则仅仅是替换字符串.</p></li><li><p class="paragraph">并且本函数支持反向引用捕获组, 使用方法等同于RegEx: $捕获组索引</p></li><li><p class="paragraph">和<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index.html">replace</a>函数不同的时本函数会保留原有<a href="https://developer.android.com/reference/kotlin/android/text/Spanned.html">android.text.Spanned</a>的效果</p></li></ol></div></div></div></div></div></div></div></div></div></div></div>
<div class="divergent-group" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="with-platform-tags"><span class="pull-right"></span></div>

  <div>
    <div class="platform-hinted " data-platform-hinted="data-platform-hinted"><div class="content sourceset-depenent-content" data-active="" data-togglable=":engine:dokkaHtml/release"><div class="symbol monospace">fun <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a>.<a href="replace-span.html">replaceSpan</a>(regex: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/index.html">Regex</a>, quoteGroup: <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html">Boolean</a> = false, replacement: (<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/index.html">MatchResult</a>) -&gt; <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html">Any</a>?): <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a><span class="top-right-position"><span class="copy-icon"></span><div class="copy-popup-wrapper popup-to-left"><span class="copy-popup-icon"></span><span>Content copied to clipboard</span></div></span></div></div></div>
  </div>
<p class="paragraph">使用正则替换匹配字符串</p><h4 class="">Return</h4><p class="paragraph">如果没有匹配任何项会返回原来的<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">CharSequence</a></p><h2 class="">Parameters</h2><div data-togglable="Parameters"><div class="platform-hinted WithExtraAttributes" data-platform-hinted="data-platform-hinted" data-togglable="Parameters"><div class="content sourceset-depenent-content" data-active="" data-togglable=":engine:dokkaHtml/release"><div data-togglable="Parameters"><div class="table" data-togglable="Parameters"><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">regex</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">正则</p></div></div></div></div></div><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">quoteGroup</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">是否允许反向引用捕获组</p></div></div></div></div></div><div class="table-row" data-filterable-current=":engine:dokkaHtml/release" data-filterable-set=":engine:dokkaHtml/release"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex">replacement</span></div><div><div class="title"><div data-togglable="Parameters"><p class="paragraph">每次匹配到字符串都会调用此函数</p><ol><li><p class="paragraph">如果返回null则表示不执行任何操作</p></li><li><p class="paragraph">返回单个Span则应用效果, 当然返回Span集合或数组就会应用多个效果,</p></li><li><p class="paragraph">返回<a href="https://developer.android.com/reference/kotlin/android/text/Spanned.html">android.text.Spanned</a>可以替换字符串同时添加Span效果.</p></li><li><p class="paragraph">返回<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html">kotlin.CharSequence</a>则仅仅是替换字符串.</p></li><li><p class="paragraph">并且本函数支持反向引用捕获组, 使用方法等同于RegEx: $捕获组索引</p></li><li><p class="paragraph">和<a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index.html">replace</a>函数不同的时本函数会保留原有<a href="https://developer.android.com/reference/kotlin/android/text/Spanned.html">android.text.Spanned</a>的效果</p></li></ol></div></div></div></div></div></div></div></div></div></div></div>
        </div>
        <div class="footer"><span class="go-to-top-icon"><a href="#content"></a></span><span>© 2021 Copyright</span><span class="pull-right"><span>Generated by </span><a href="https://github.com/Kotlin/dokka"><span>dokka</span><span class="padded-icon"></span></a></span></div>
      </div>
    </div>
  </body>
</html>

